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I. Hardware Concerns 


Instructions for connecting the ATR8000 system are in the ATR8000 Owner's 
Manual. This section contains information specific to running CP/M on the 
ATR8000. 


1.1. Using an AVAR! or an RS-232 Terminal 


The 64k ATR8000 system runs CP/M either through an ATARI 800/400 or an RS-232 
terminal. If the ATARI 800/400 is used, it is sent a terminal program, Auto- 
Term, during the CP/M hoot procedure. After Auto-Term is run, the ATR8000 is 
the master processor in the ATR8000-ATARI system. 

CP/M has an 80 character line width. On the standard ATARI 800/400, CP/M 
displays are shown in a movable 40-column window. SVP has a special Auto-Term 
program available for Bit 3™ 80-column owners that displays all 80-columns 
simult aneously. 

RS-232 terminal users do not use the Auto-Term program. Terminals 
automatically display all 80 columns in CP/M. RS-232 terminals need to be 9600 
baud, odd parity and 7 bits and they must emulate the ADIi-31 /Soroc/Televideo 

protocol. 


1.2. Disk Drives 


As explained in the ATR8000 Owner’s Manual, the ATR8000 supports a wide 
variety of disk drives. As shipped, the 5 1/4" ATR8000 CP/K disk will boot on 
35 track and 40 track single or double-sided drives. Users that only have oU 
tr ack (single or double—sided) 5 1/4" drives, need to get a special CP/M disk 
from their dealer or from SWP Microcomputer Products. Althou^i the 5 1/4 CP/M 
disk will boot on 35 track and 40 track single or double-sided drives, the 
system tracks need to be customized if you are using anything but 40 track, 
single-sided drives. This is done using DDSYSGEN. Do any customizing before 
experimenting with CP/M. 

As shipped the 8 M CP/M disk is for 77 track single-sided drives. It will also 
boat on 77 track double-sided drives, but owners of these drives need to 
customize the CP/ll disk. This is explained in the DDSYSGEN instructions. 

Users that have a mixture of drive types, also need to customize their CP/M. 
This is done using DDSYSGEN. 

As explained _in the ATR8000 Owner's Manual, CP/M must be booted from Drive A 
and this must be a standard disk drive. Percom drives with the controllers 
intact and ATARI 810 drives cannot be used for CP/M. 
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1.3. Printers 


Either a serial or a parallel printer can be used with CP/M. A parallel 
printer connects to the PRINTER Port; a serial printer connects to the RS-232 
Port. The CP/M disk contains a parallel printer driver. This can be changed to 
a serial driver by using the symbolic patch function of DDSYSGEN to change 
location IIOBYT. This is is explained in the DDSYSGEN instructions. 

The RS-232 Port is default configured for an Epson serial printer. If you are 
using a different type of serial printer, consult the ATR8000 Owner's Manual 
to properly configure this Port (using J12). 


1.4- Modems 


A modem can be connected to the RS—232 Port. The CP/M disk contains a multi 
function modem program, MODEM.COM. Detailed instructions for this program are 
listed in the file MODEM.DOC. Use the TYPE command of CP/M to read this file. 
(To temporarily halt the display, type a <CTRLXS>. Another <Cj.RLXS> will 
restart it.) [The command is: TYPE MODEM.DOC<RETURN>; To print the file, enter 
a <CTRLXP> before pressing <RETURN>.] 

RS-232 Port peripherals require the proper configuring of J12. Consult the 
ATR8000 Owner's Manual for details. 


II. Booting CP/M 


This section is divided in three parts. The first contains boot instructions 
for ATR8000-ATARI users, tells how to backup the Auto-Term disk, and lists the 
special keys that move the 40 column display window. The second contains boot 
instructions for RS-232 terminal users. The last tells how to backup the CP/M 

disk. Backup your CP/M disk before experimenting with CP/M. 


II. 1. Booting CP/M with an ATARI 800/400 


Booting CP/M with an ATR8000-ATARI system is a two-step procedure. For CP/M, 
the ATARI turns over system control to the ATR8000 after it receives a 
terminal program, Auto—Term. After Auto—Term is active, CP/M is booted. 


Step 1 Turn the power on the ATR8000 and the disk drives. 

Step 2 The drives' motors will run for roughly 3 seconds. When the motors 
stop, insert the Auto-Term disk in Drive A and turn on the ATARI. 

Step 3 If there isn't a BASIC cartridge in the ATARI, after a few seconds, 
"ATRMON" and its prompt will show on the screen. Remove the disk. 

If there is a BASIC cartridge in the ATARI, after a few seconds 
"READY" will show on the screen. Type: "DOS<RETURN>". The screen will 
show "ATRMON" and its prompt, Remove the disk. 

Step 4 Put the CP/M disk in Drive A. Type: "B<RETURN>". CP/M is now booted 
and its prompt "A>" shows on the screen. 


II. 1 .A. Backing Up Auto-Term 


The Auto—Term disk is an ATARI DOS disk. To back it up, do the following. 

Step 1 From the ATARI DOS menu, format a disk that the backup copy will be 
written to. [Use the I option.] 

Step'2 From the ATARI DOS menu, choose the J option to copy Auto-Term from 
the master to the backup disk. 


II. 1 .B. Terminal Program Controls 


Operating ATARI DOS or 0SA+, the ATARI has a 40 column display width on the 
interfaced television's screen. Once the ATARI is being used as a terminal for 
CP/M, this display is a full 80 columns by 24 rows. The additional 40 columns 
are accessed by scrolling the screen display right and left. (As long as a 
television is used as a monitor there can only be 40 columns visable on the 
television's screen due to band width limitations. ) 
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Think of the 40 columns shown as a 40 column wide window of an 80 character 
wide display space. Technically these 80 columns are referred to as Columns 0 
- 79, rather than Columns 1 - 80. The normal position of the window shows the 
first 40 columns of the display, Columns 0 - 39* 

Following is a list of commands that move the display window. The keyboard 
commands are direct commands which are not transmitted to the ATR8000. The 
other commands must be transmitted from the ATR8000. 

Moving the Display Window: 

i*rom the Keyboard 

1) CTRL BACK S This toggle command switches the display window to show 

either the first 40 columns or the last 40 columns of the 
80 column display. For example, if the first 40 columns 
show on the screen (Columns 0 - 39) > entering CTRL BACK S 
changes the display to show the last 40 columns (Columns 40 
~ 79)* [A HOME code also moves the window to show Columns 0 
- 39-] 

2) CTRL ; Moves the display window one column to the right. (The 

window will not move if this command is entered and the 
last 40 columns are currently displayed on the screen 
|Columns 40 - 79}-) 

Moves the display window one column to the left. (The 
window will not move if this command is entered and the 
first 40 columns are currently displayed on the screen 
{Columns 0 - 39)•) 

3) CTRL 3 This toggle command turns the Auto Display mode on and off. 

When the Auto Display mode is active, the display window 
moves with the cursor. (The default is on.) 


From the ATR8Q0Q 

1) ESC > An ESC > sequence moves the display window one column to 

the right. (The window will not move if this command is 
received and the window currently shows the last 40 columns 
{Columns 40 - 79)0 

ESC < An ESC < sequence moves the display window one column to 

the left. (The window will not move if this command is 
received and the screen currently displays the first 40 
columns {Columns 0 - 39)*) 

2) ESC Zn An ESC Z sequence can be used to set the Auto Display mode 

to follow the cursor. For more information about ESC Z and 
the ESC Z variables, consult Section V.3« 
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II.2. Booting CP/M from a Terminal 


Booting CP/M from a terminal is a simple process. 


Step 1 Turn the power on the system. 

Step 2 The drives' motors will run for about 3 seconds. When the motors shut 
off, insert the CP/M disk into Drive A. 

Step 3 Press <RETXJRN>. ATRMON and # will show on the screen. 

STEP 4 Type B<RETURN>. (B stands for "boot.") CP/M is now booted and its 
signon message shows on the screen (A>). 

II.3. Backing Up the CP/M Disk 


Before continuing, backup the CP/M disk. The programs used in this process are 

explained in detail later in this supplement. 

Step 1 With the CP/M disk in Drive A, type DDINIT and press <RETURN>. This is 
a disk initializing program. DDINIT and its menu will show on the 
screen. Remove the CP/M disk from Drive A. 

W Step 2 Choose Format #4 (it puts the most space on a disk). Select A as the 
Drive ID. Insert a blank disk into Drive A. [5 1/4" disks must not 
have a write-protect tab on the disk notch. 8" disks need a foil 
write-protect tab over the notch in the disk.] Press Y to format. 

Step 3 When the format is completed, remove the newly-formatted disk from 
Drive A and reinsert the CP/M disk. Enter <CTRLXC> to return to CP/M. 

Step 4 Type DDSYSGEN and press <RETURN>. This is a double density system 
tracks copy program. Choose Function 1 and read the tracks off of the 
disk in Drive A. When the menu reappears, remove the CP/M disk from 
Drive A. 

Step-5 Insert the newly-formatted disk into Drive A. Select Function 2 and 
write the system tracks onto this disk. When this is done, the double 
density CP/M disks have been copied to this disk. 

Step 6 To move all the files from the master CP/M disk to the backup CP/M 
disk, put the master CP/M disk in Drive A and the backup copy in Drive 
B. Type: PIP B:=A:*.*[VJ 

NOTE: If you only have one drive, you will need to do the OilEDSK patch 
(listed in the DDSYSGEN section) before you can copy the files. ONEDSK 
will let you use one drive to copy between disks. 



III. CP/M in Brief 


This section briefly describes some of the functions and operations of CP/M. 
It is NOT a detailed account of either and should be used accordingly. The 
CP/M manual from Digital Research describes CP/M in detail. 


Ill. 1. Filenames 


In CP/M filenames must fit a specific pattern. The name is divided into a 
filename, optionally followed by a period (.) and an extent. The filename can 
be up to eight digits, the extent up to three. [ FILENAME.EXuJ Extents are 
generally used to describe what type of file it is. For example, a text file 
might have .TXT or .DOC for the extent. Compiled CP/M programs use .COM for 
theextent, so do not use this for noncompiled programs. Other extents with 
specific meanings are .ASM, .MAC, .REL, .OVR and .LIB. Some sample names are. 

MANUAL.TXT DISKMON. COM DOCUMENT DETAILS. DOC STAT.COM SYSTEM. SUP 

In CP/M compiled programs run after the filename is entered. For example, 
PIP.COM runs after PIP<RETURN> is entered. 

Ambiguous Filenames For some CP/M commands, filenames can be referred to 
either* ambiguously or specifically. There are two special characters, and ., 
that are used to refer to ambiguous names. ? allows ambiguous reference to one 
Sir* allows ambiguous reference to all digits on one side of the period 
that separates the name and the extent. 

Some examples: 

If you had a disk with the following files on it: CHAPTER1 .TXT, CHAPTER2.TXT 
and CHAPTER3.TXT, all can be referenced by CHAPTER7.TXT. If you had a dis 
with varies files on it and wanted to see a directory listing of only the 
CHAPTER files, the command: DIR CHAPTER?.TXT would list them. 

If you had a disk with the files: DDCOPY.COM, DDSYSGEN.COM, and DDINIT.COM, 
a~n can be referenced by DD*.C0M or DD??????.C0M. 

The ambiguous file references can be used with the STAT program^ provide 
■specific statistics for each file on a disk, ihis command is SxAi . 


III.2. Built-in Commands 


CP/M has five built-in commands. These commands and a brief description of 
their uses follow. 

Command Function 

ERA Erases specified files. 

DIR Lists file names in a directory. The type of directory, such 

as only .COM files, can be specified. 
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KEtf Renames a specific file. This follows the pattern of 

EEWNAME • EXT=OLDNAME. EXT. 

SAVE Saves memory contents in a file. The amount of memory to be 

saved must be specified. 

TYPE Types the contents of a file on the display. If TYPE is 

entered after a <CTRLXP>, then the contents will be 
displayed on the screen and printed on the printer (if on¬ 
line) at the same time. 


III. 3. CP/M Programs on the ATR8000 CP/M Disk 


To see a display of the CP/M programs on the ATR8000 disk, first hoot CP/H, 
then do a directory of the disk. [Prom the CP/M prompt A>, type 
"DIR<RETURN>".] Your disk should have the following programs (they may be m a 

different order): 


A: MODEM 
A: DISKMON 
A: DDT 
A: DUMP 
A: STAT 
A: DISKDEF 


DOC : DDINIT 
COM : ASM 
COM : DEBLOCK 
COM : ED 
COM : SUBMIT 
COM : MOVCPM 


COM : MODEM 
COM : BIOS 
ASM : DISKDEF 
COM : LOAD 
COM : SYSGEN 
COM : SYSTEM 


COM 

COM 

LIB 

COM 

COM 

SWP 


DDSYSGEN COM 
CBIOS ASM 
DUMP ASM 
PIP COM 
XSUB COM 


Some of these programs are from Digital Research and some are from SWP. x 
Digital Research CP/M programs are explained in their CP/M manual, iwo of th 
Digital Research programs are used extensively in disk operations; these are 
PIP.COM and STAT.COM. 


III.3.A. PIP.COM 


PIP.COM is a command file. It is executed by entering PIP followed by a 
command string. PIP equations follow the format: 

destination drive:destination filename = source driveisource filename 


A valid example is: A>PIP A:STAT.COM=B:STAT.COM 
Drive B to Drive A.] 


[This copies STAT.COM from 


If the destination filename is the same as the source filename (i.e. you don’t 
want to rename it), then it is not necessary to list the destination filename. 


Following this guideline, the above example could also be: 

A>pip A: =B:STAT.COM [This also copies STAT.COM from Drive B to Drive A.] 


Verifying The PIP equation can be followed by [V]. This verifies the copy 
process. It is a good idea to always ^verify. For example, the above equation 
with the verify option would be: 


ays veriiy- caqiuu. 
A>PIP A: =B: STAT .COM [ V J 
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Ambiguous Filenames As with many CP/M progrgams, PIP accepts ambiguous 
filenames. If you want to copy all files from Drive B to Drive A, you could 
w type: A>PIP A:=B:*.*[V] 

!o copy all the command files from Drive B to Drive A, you could type: A>PIP 
A:=B:*.C0M[V]. More on ambiguous filenames and other PIP possibilities are in 
the Digital Research CP/M manual. 


III.3.B. STAI.COM 


STAT.COM is a command file. One of its uses is to determine disk statistics. 
The following will describe some of STAT's uses in this context. For other 
STAT information, consult the Digital Research CP/M manual. 

STAT is used to determine how much storage space is left on a disk. Entering: 
A>STAT will tell you how much space is left on Drive A. The remaining space on 
Drive B will be shown if you enter: A>STAT B: 

File Size To get specific information about the size of particular files, 
STAT can be followed by a filename, specific or ambiguous. Some examples: 

STAT CHAPTER7.TXT will list statistics on all files CHAPTER7.TXT. The 
statistics will take the form: 

REGS BYTES EXT ACC DRIVE: FILENAME. EXT 

At the end of the listing, the remaining number of available bytes is listed. 

STAT *.* will list statistics on all files on a disk. 

If you are not sure that you have room for a file on a particular disk, use 
STAT to gauge the file's size and also use it on the disk you want to copy the 
file to. 

Disk Characteristics Statistics on a disk can be obtained by the STAT command: 
STAT DSK: (STAT B:DSK: for Drive B). Among the printout will be : Kilobyte 
Drive Capacity. This tells you the total storage space of a disiTYTBy looking 
at this number, you can determine if a disk is single or double density. For 
example: a single' density 8" disk has a capacity of 256k and a double density 
disk formatted with the 1024 byte format has a capacity of 674k. 


III. 4 . SVP ATR8000 CP/M Programs 


The SWP CP/M files on your disk are: 

DDINIT.COM for formatting and verifying single and double density disks. 

DDSYSGEN.COM for reading, writing and customizing double density system 
tracks. (Use SYSGEN.COM for reading and writing single density 
system tracks.) 


DISKI-lON.COM allows primitive disk access for analyzing and editing. 
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MODEM.COM 

MODEM.DOC 
SYSTEM.SWP 

DISKDEP.COM 


a multifunction modem program for modems connected to the RS-232 
Port. 

a document file containing instructions for MODEM.COM 

this file is used by DDSYSGEN in the customizing of system 
tracks. 

a program that sets Drive B to have the characteristics of other 
computers. This allows various single and double density CP/M 
disk formats to be used with the ATR8000. 


These programs are thoroughly explained in Section IV. 


III.5- CP/M Disk Formats That Don't Need DISKDEP.COM 


The ATR8000 is able to read various single and double density CP/M disk 
formats. Some of these formats can be run on the ATR8000 as is;, they don't 
require any type of a setup program (such as DISKDEIF.COM). These disks are: 

8 " — All IBM standard single density, single-sided CP/M disks 

5 l/ 4 M — Single density, single-sided Xerox 820 disks 
Single density, single-sided Cromemco disks 

The above disks can be used in two ways: 

#1 With no modification they can be run from Drive B, C or D, or 

#2 They can be DDSYSGENed with ATR8000 CP/M and then run in Drive A. [To do 
this: run DDSYSGEN, use #1 to read the double density CP/M tracks off of 
an ATR8000 CP/M disk into memory, use #2 to write these tracks from memory 
onto the disk. #2 of DDSYSGEN automatically double density formats the 
system tracks of a disk before writing to it.] 

DISKDEF.COM, discussed in Section IV, allows other disk formats to work with 
the ATR8000. 


III.6. Using Different Densities in Different Drives 


The ATR8000 is able to run both single and double density disks. Your ATR8000 
CP/M disk is double density. Single density disks can be run in Drive B, C or 
D. Programs can be copied from single density disks to double density disks 
using PIP. 

You'll want to run most of your programs on double density disks because 
double density operation is much faster than single density operation. If you 
purchase programs on single density disks, simply PIP the files to double 
density disks. 



IV. SWP CP/M Utility Programs for the ATR8000 


This section describes the SWP CP/M utility programs for the ATR8000. These 
programs have user-oriented displays and prompts that simply explain options 
and directions. You may find it useful to run each program while reading the 
following information. 


IV. 1. DDUHT.COM — Disk Initializing 


When DDINIT is run, a signon message will appear on the screen. It will 
instruct you to remove all valuable disks before continuing. This is to 
prevent the accidental reformatting (and, therefore, erasing) of any good 
disks. DDINIT will remain in the computer’s memory until you exit the program. 

After all disks are removed (you can simply open the drives' doors), press 
<KETURN>. After doing so a menu of format selections shows on the screen: 

- Disk Format Menu - 


density 

1) single 

2) double 

3) double 

4) double 


sector size 
128 bytes 
256 bytes 
512 bytes 
1024 bytes 


enter number of format (1 to 4) 


Choose a format and press <RETURN>. The next prompt instructs you to enter a 
drive ID (A,B,C, or D). This is the drive that is to be used to format the 
disk. Enter a drive ID and press <RETUKN>. Insert the disk to be formatted in 
the drive. 8” disks must have a foil tab placed over the write-protect notch 
in the disk. 5 1/4" disks cannot have a tab on them. 

After this selection is entered, the prompts say to press <Y> to format or to 
press <CTL-C> to exit to CP/M. If you have removed the system disk from Drive 
A, it must be reinserted to exit to CP/M. If it is not, the computer will have 

to be rebooted. 


If, after entering the format and drive ID, you decide that you want to. change 
the selection, simply press <RETURN> instead of <Y> or <CTRLXC>. This wil 
return you to the DDINIT menu. 


As the disk is being formatted, the screen will show the track currently 
done. The program formats and then verifies each track before going on to the 

next. 


If any error messages occur during the format, DO NOT use that disk unless you 
reDDINIT it and it passes with no errors. If there are any bad sectors on a 
disk, the error message will look like the following: 

TRACK 39 *** 1 bad sector(s) *** 


When the format is complete, if any bad sectors occurred, a message like the 



following will appear: 


done ... 1 bad sectors detected 

If the drive door on the drive to be used in formatting is open, if the disk 
is inserted into the drive incorrectly, or if the specified drive is not 
connected to the system, the following error message will appear: 

*** DRIVE NOT READY *** 

(drive door open? disk in wrong?) 

Here you have three options: 

1) Correct the problem and press <Y> to format, 

2) Press <CTRLXC> to exit to CP/M (if a system disk is in Drive A), or 

3) Press <RETURN> to choose another set of format selections. 


IV.2. DDSYSGM.COM — Reading, Writing and Generating CP/M System Tracks 


DDSYSGEN is a program for reading, writing and customizing double density CP/M 
system tracks. The system tracks are the first two tracks of the disk. When 
these tracks have the CP/M system written onto them, the disk is able to boot 
the computer. All disks that will be used in Drive A must have system tracks 
on them. Disks used in other drives can have system tracks on them, but they 
don't have to have them. 

Run DDSYSGEN. The following menu will appear on the screen: 

... system generator for ATR8000 ... 
functions available: 

1) Read system tracks from disk. 

2) Write system tracks to disk. 

3) Generate customized CP/M. 

enter number of function (1,2, or 3) 
or press <CTL-C> to exit to CP/M ... 


After the DDSYSGEN menu appears, the disk it was run from can be removed from 
the computer. DDSYSGEN will remain in memory until the command to exit to CP/M 
is executed. (Before exiting make sure that a system disk is in Drive A.) 


1) Read system tracks from disk: 

This function reads existing double density system tracks from a disk into 
memory. This is the first step in copying system tracks from one disk to 
another and in reading tracks to alter them. When you select <1> and press 
<RETURN> the screen will show: 


- Read System Tracks — 

enter drive name (A,B,C, or D) 


press <RETURN> when ready 
or <CTL-C> to abort • • • 

Enter a drive name, insert the disk whose tracks are to be read into the drive 
and press <RETURN>. In a few seconds, "function complete" will show on the 
screen and then the menu will reappear. 

If the tracks being read are errored, the message "DISK I/O ERROR will flash 
on the screen before "function complete." 


2) Write siystem tracks to disk. 


This function writes double density system tracks from memory onto a specified 
disk. It is used after #1 and #3* Before DDSYSGEN writes the tracks onto the 
disk, it reinitializes the system tracks of the disk. 


As with Option 1, the write option asks for the drive to be used. Enter the 
drive name, insert the disk, and press <RETURN>. In a few seconds "function 
complete" will show, then the menu will show on the screen. 


If there is an error in this procedure, "DISK I/O ERROR IN SYSTEMS AREA" will 
flash on the screen. Make sure that 8" disks have a write-protect tab on them 
and that 5 1/4" disks do not. 


To test system tracks written onto a disk, cold boot the computer with that 
disk. 


Once system tracks are in memory, Option 2 can be used repeatedly. For 
example, if you are making a pile of new system disks, read the system tracks 
into memory with #1, then use #2 until all disks have been written to. 


3 ) Generate customized CP/M 

This option is used to customize CP/M to precisely match your system. The 
ATR8000 system allows the connection of a wide variety of peripherals. The 
following set of peripherals is the SWP standard: 


- single-sided, 40 track 5 1/4" drives. 

- single-sided, 77 track 8" drives. 

- 16 ms head settling time. 

- a step rate that automatically adjusts to the fastest rate the drive 
is capable of running. (This rate can be marginal for some drives, so 
the symbolic patch function allows the user to set a defined rate.; 

- a 50 ms head load delay. 

—Ik byte block size for 5 l/4 n disks. 

- a parallel printer. , . , /n 

- RS-232 communications port configured for 1200 baud/odd parity//' 

bits/full duplex. 


If you have other peripherals, or if your peripherals do not meet all of the 
above standards, the CP/M system tracks must be customized using this option 
of DDSYSGEN. 

When you select <3> and press <RETURN>, the following shows on the screen: 

—- Generate Custom system —- 

insert disk with SYSTEM.SWP file 
into drive A and press <RETURN> ... 

SYSTEM.SWP comes on the ATR8000 CP/M disk. When <RETURN> is pressed, the 
system is read from this file into memory. The screen will show "reading 
system" followed by a string of "+"s. If SYSTEM.SWP was not on the disk in 
Drive A when <RETURN> was pressed, the error message "CANNOT READ SYSTEM FILE" 
will show on the screen along with the message "press any key to return to 
main menu." Pressing any key will return the system to the DDSYSGEN menu. 

When the system is read, the following message will show: 

Do you wish to use the symbolic 
patch function to change any 
system parameters from their 
default values? (y/n) ... 

To customize the system tracks, enter <Y>. The screen will show: 

param? ... 

The parameters that can be changed are listed below. When a parameter is 
entered the screen will show the parameter and its current value, and it will 
ask for the change to value. This follows the format: 

param?_=_ change to? ___ 

When all desired parameters are entered, press <CTL-C> to return to the 
DDSYSGEN menu. Then use Option 2 to write the newly customized tracks onto a 
double density disk. 


Making Changes: 

Symbolic patch function data entries are entered in hexadecimal. Binary to 
hex, decimal to hex, and decimal to binary charts follow. Use these charts 
along with the instructions in each subsection to compute proper data entries 
for any changes made. 



Binary 

0000 

Hex 

0 

Dec. 

0 

Hex 

0 

Dec. Hex 

55 37 

Dec. Hex 

110 “6e 

Dec. Hex 
IE 5 A5 

0001 

1 

1 

1 

56 

58 

111 

6F 

166 

A6 

0010 

2 

2 

2 

57 

59 

112 

70 

167 

A7 

0011 

3 

5 

5 

58 

5A 

115 

71 

168 

A8 

0100 

4 

4 

4 

59 

5B 

114 

72 

169 

A9 

0101 

5 

5 

5 

60 

5C 

115 

75 

170 

AA 

0110 

6 

6 

6 

61 

5D 

116 

74 

171 

AB 

0111 

7 

7 

7 

62 

5E 

117 

75 

172 

AC 

1000 

8 

8 

8 

65 

5F 

118 

76 

175 

AD 

1001 

9 

9 

9 

64 

40 

119 

77 

174 

AE 

1010 

A 

10 

A 

65 

41 

120 

78 

175 

AP 

1011 

B 

11 

B 

66 

42 

121 

79 

176 

BO 

1100 

C 

12 

C 

67 

45 

122 

7A 

177 

B1 

1101 

D 

15 

D 

68 

44 

125 

7B 

178 

B2 

1110 

E 

14 

E 

69 

45 

124 

7C 

179 

B5 

1111 

P 

15 

P 

70 

46 

125 

7D 

180 

B4 


16 

10 

71 

47 

126 

7E 

181 

B5 

Binary Decimal 

17 

11 

72 

48 

127 

7F 

182 

B6 

00000 

0 

18 

12 

75 

49 

128 

80 

185 

B7 

00001 

1 

19 

15 

74 

4A 

129 

81 

184 

B8 

00010 

2 

20 

14 

75 

4B 

150 

82 

185 

B9 

00011 

3 

21 

15 

76 

4C 

151 

85 

186 

BA 

00100 

4 

22 

16 

77 

4D 

132 

84 

187 

BB 

00101 

5 

25 

17 

78 

4E 

155 

85 

188 

BC 

00110 

6 

24 

18 

79 

4F 

154 

86 

189 

BD 

00111 

7 

25 

19 

80 

50 

155 

87 

190 

BE 

01000 

8 

26 

1A 

81 

51 

156 

88 

191 

BP 

01001 

9 

27 

IB 

82 

52 

157 

89 

192 

CO 

01010 

10 

28 

1C 

85 

55 

158 

8A 

195 

Cl 

01011 

11 

29 

ID 

84 

54 

159 

SB 

194 

C2 

01100 

12 

50 

IE 

85 

55 

140 

8C 

195 

C5 

01101 

15 

51 

IP 

86 

56 

141 

8D 

196 

C4 

oiiio 

14 

52 

20 

87 

57 

142 

8E 

197 

C5 

01111 

15 

55 

21 

88 

58 

145 

8P 

198 

C6 

10000 

16 

54 

22 

89 

59 

144 

90 

199 

C7 

10001 

17 

55 

25 

90 

5A 

145 

91 

200 

C8 

10010 

18 

56 

24 

91 

5B 

146 

92 

201 

C9 

10011 

19 

57 

25 

92 

5C 

147 

95 

202 

CA 

10100 

20 

58 

26 

95 

5B 

148 

94 

205 

CB 

10101 

21 

59 

27 

94 

5E 

149 

95 

204 

CC 

10110 

22 

40 

28 

95 

5F 

150 

96 

205 

CD 

10111 

25 

41 

29 

96 

60 

151 

97 

206 

CE 

11000 

24 

42 

2A 

97 

61 

152 

98 

207 

CP 

11001 

25 

45 

2B 

98 

62 

155 

99 

208 

DO 

11010 

26 

44 

2C 

99 

65 

154 

9A 

209 

D1 

11011 

27 

45 

2D 

100 

64 

155 

9B 

210 

D2 

11100 

28 

46 

2E 

101 

65 

156 

9C 

211 

D5 

11101 

29 

47 

2F 

102 

66 

157 

9D 

212 

D4 

11110 

50 

48 

50 

105 

67 

158 

9E 

215 

D5 

11111 

51 

49 

51 

104 

68 

159 

9F 

214 

D6 

50 

52 

105 

69 

160 

AO 

215 

D7 



51 

55 

106 

6A 

161 

A1 

216 

D8 



52 

54 

107 

6B 

162 

A2 

217 

D9 



55 

55 

ice 

6C 

165 

A5 

218 

DA 



54 

56 

109 

6D 

164 

A4 

219 

DB 


16 


Dec. Hex 

220 DC 

221 DD 

222 DE 

223 DP 

224 E0 

225 El 

226 E2 

227 E3 

228 E4 

229 E5 

230 E6 

231 E7 

232 E8 

233 E9 

234 EA 

235 EB 

236 EC 

237 ED 

238 EE 

239 EP 

240 FO 

241 PI 

242 F2 

243 F3 

244 F4 

245 F5 

246 F6 

247 F7 

248 F8 

249 F9 

250 PA 

251 FB 

252 PC 
255 ED 

254 PE 

255 PP 


Head Settling Time and Step Rate 


Locations: RATEA, RATEB, 
RATBC, RATED 


Each of these locations is for one of the four possible CP/M drives: Drive A, 
Drive B, Drive C, and Drive D. The industry standard head settling time is 16 
ms (milliseconds). [This is the default value.] The ATR8000 automatically 
adjusts the step rate of each drive to the fastest rate the drive will run. It 
is possible that this rate will be marginal, i.e., the drive may have 
occasional problems running at this speed. These locations allow you to select 
a determined rate for each of the four possible drives. 

Values for settling time and step rate are entered into a binary chart 
(depicting 8 bits or one byte) and then translated into hex. A binary number 
is four digits long, therefore, the byte is divided into two 4 bit sections. 
Each of these sections contains a binary number which is translated into hex. 
Then these two hex numbers make up the final value. 


i 

i 

i 

i 


i 

i 


xjxjx 


X I V I V 1 V 1 V • 
I A | A | A | A | 


T-1 

I I 



These two bits determine the step rate. The 
"possible values for 5 1/4" and 8" drives: 

Value 5” time 8" time 



6 ms 

3 ms 

01 

12 ms 

6 ms 

10 

20 ms 

10 ms 

ii 

30 ms 

19 ms 


j These 6 bits determine the head settling time. The 
default is 16 ms (the industry standard). The desired 
settling time is divided by four, then this product is 
entered, in binary, into these six bits (beginning in 
the rightmost bit). Any extra bits are filled with Os. 


For example: The following shows this location with a 16 ms head settling time 
and a step rate of 3 ms for an 8 M drive. 


!0!Oioji|o;oio!oi 

i-1—i 

i_■_i i 

j 00 is 3 ms for an 8” drive as shown above. 


j 16 ms is the desired rate. 16 divided by 4 is 4 in 
decimal. This decimal 4 must be converted to binary. 

The binary value for 4 -decimal is 0100 (as shown in the 
decimal to binary chart), so 0100 is entered into the 
rightmost bits, and the remaining two bits are filled 
with Os. 

Now the bit chart is complete. The first four bits are 0001 binary, or 1 hex. 
The last four bits are 0000, or 0 hex. Therefore, the value to enter at 
location RATEA to set Drive A to have a head settling time of 16 ms and a step 
rate of 3 ms, is 10. [Notice that you do NOT add the digits together (i.e., 
1+0=1), rather the left four bits make up the left digit, 1, and the right 
four bits make up the right digit, 0.] 
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If you change any of these locations, be sure that RATEA is changed for Drive 
A, RATEB for Drive B, and so on. 

Head Load Delay Location: HDLDTM 

Head load delay is the amount of time between selecting a new drive and doing 
any reads or writes to the new drive. The value is determined in decimal, then 
converted to hex. The default is 50 ms, or 32 hex. Possible decimal values are 
from 1 to 255 ms. 


Multiple or Single Drive System Location: ONEDSK 

The value at this location determines if the system is a single drive or a 
multiple drive system. The default is for multiple drives. Single drive system 
users need to change this value. 

* Users with one drive systems can refer to Drive A as A, B, C or D when 
ONEDSK is set to 1. This allows the drive to run nonsysgened disks and allows 
one drive to copy disks. Por example, with this set to 1, you can use PIP to 
make a copy of a disk by referring to the drive as both A and B. The computer 
will instruct you when to swap disks during the procedure. With this set to 1, 
you can run a nonsysgened disk in the drive by referring to the drive as B, C 
or D, rather than A. 


Value Meaning 

0 Multiple drives 

1 Single drive 


Type of Drives 


Locations: NTRKSA, NTRKSB 
NTRKSC, NTRKSD 


These locations correspond to Drive A, Drive B, Drive C and Drive D. If your 
system has drives other than single-sided 40 track 5 1/4" or 77 track 8", 
then customize the system to fit your drives. Enter the appropriate hex value 
for each drive using the following chart: 


Value (hex) 
23 
9F 
28 
A8 
50 
DO 
4D 
CD 


Type of D 
35 track, 
+35 track, 
*40 track, 
+40 track, 
+80 track, 
+80 track, 
*77 track, 
77 track, 


single-sided 

double-sided 

single-sided 

double-sided 

single-sided 

double-sided 

single-sided 

double-sided 


5 1/4" drive 
5 1/4" drive 
5 1/4" drive 
5 1/4" drive 
5 1/4" drive 
5 1/4" drive 
8" drive 
8" drive 


* The ATR8000 is preconfigured to accept these types of drives, so it is not 
necessary to enter either of these values. (It can distinguish between 5 1/4" 
and 8" drives.) 


+ These types of drives also require that location DD5IN (CP/M disk parameter 
block section) is changed. 
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For Users with Nonstandard Drives: 

If your drive is not listed above, the value can be determined by the 
following process. The value can be determined in decimal, then entered in 
hex. 

Single-sided drives: Determine the number of tracks the drive has. Then use 
the decimal to hex charts to convert this number to hex. For example, 40 
decimal equals 28 hex. Enter this value for the location. 

Double-sided drives: Determine the number of tracks the drive has. Now add 128 
(decimal) to the track number. Convert this number to hex and enter it at the 
location. 

For example: To compute the value for a 40 track, double-sided drive, add 40 
and 128. 168 = A8 hex, the value to be entered. 


CP/M Disk Parameter Blocks Locations: DD8IN, DD5IN 

The CP/M block size is preset to be 2k byte blocks for 8" disks and Ik byte 
blocks for 5 1/4" disks. WE DO NOT RECOMMEND CHANGING THE 8" BLOCK SIZE. 

5 1 /4" Users: CP/M only allows for 256 Ik blocks of disk storage. Double-sided 
5 1/4” drives and single-sided 80 track drives exceed this (remember this is 
double density CP/M — a double density, double-sided 40 track drive can have 
up to 590k bytes of storage). In order to realize all possible space, the 
block size needs to be changed to 2k blocks. 

If any double-sided 5 1/4" drives or any 80 track drives are connected, make 
the following location changes: 


Location 

Default 

Enter 

*DD5IN+4 

03 

04 

DD5IN+5 

07 

OF 

DD5IN+9 

3F 

7F 

DD5IN+13 

10 

20 


* To access the location +n, first enter the location (DD5IN), then press 
<RETURN> until the proper n value is accessed. 


RS—232 Port Configuration Locations: IBAUD, XBAUDfl 

The RS-232 Port is preconfigured to be 1200 baud, odd parity, 7 bits and full 
duplex. These parameters must match the parameters of the peripheral 
interfaced to the RS-232 Port (and J12 must be properly configured). 

If a serial printer is interfaced to the RS-232 Port, these locations must be 
properly set along with IIOBYT. Values for some printers are at the end of 
this section. If the baud rate in IBAUD is changed, IBAUD+1 must also be 
changed. 

IBAUD: 


This location’s value is determined by computing the values in a byte (8 


bits). The numbers are entered in binary, then converted to hex. These bits 
determine mode, scale, parity, and word length (automatically determined by 
parity selection). Use the following chart: 


i 

i 

i 

i 


X 


ITT 


0 0 


0 



f~~ T his bit is related to the next 
hit. When parity is selected, 
this bit determines whether it 
is odd or even. 

Value Parity 
0 Even 

1 Odd 


| This bit selects parity or no 
parity. (The type of parily is 
determined in the bit described 
above.) This selection also selects 
word length. 

Value Selection 

This bit is 0 No parity, 8 bits 

for the scale 1 Parity, 7 bits 

of the baud rate. 

Value Meaning 

0 " > 1200 baud 

1 <= 1200 baud 


These two bits determine if a XONXOFF printer (half 
duplex) or if a full duplex communications port (or 
serial Epson printer) is selected. 

Value Selection 

. 

01 XONXOFF printer (half duplex) 

10 Full duplex communications port (or serial Epson) 

11 . 


If selections are made to run a serial printer, location 
IIOBYT must also be considered. 


IBAUD+1: 

This location is accessed by pressing <RETURN> after IBAUD. The specific baud 
rate is set here. The selections here are related to the scale selection in 
IBAUD. 


Value 

Baud Hate if 
Scale = 0 

Baud Rate 
Scale = ‘ 

OD 

• • • • 

1200 

1A 

9600 

600 

34 

4800 

300 

68 

2400 

150 

8E' 

• • • • 

110 

DO 

• • • • 

75 
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Location: IIOBYT 


Defining Character Oriented I/O Devices 

The IIOBYT is computed by determining the values in a byte. The values are 
entered in binary, then converted to hex. The byte consists of four 2-bit 
sections, one section for each in/out character oriented device. 


i 


!~X~T 

I- 

I_ 





T7 , 

-r 

i 


OTP 


! X ! T\ 

1-, 

I I 

These two bits determine the 
device used as the console. 


Value Device 


ur 

—fnmvT 

j same as CRT: but 
echoes to LST:( 

01 

CRT: 

{console is RS232 in/ 
LST: out) 

10 

BAT: 

ii 

UC1 : 

{console is RS232 


in/out| 

These two bits set the ’’reader," RDR:. 


These bits set the "punch" device, PUN:. 


| These two bits determine the list device. Serial 
printers also require that IBAUD is properly set. 

Value Device 
00 CRT: 

01 .... 

10 Parallel printer 

11 *Serial printer 


* Dtrline printers (serial) require full duplex set in IBAUD. 
Epson serial printers require full duplex set in IBAUD. XONXOFF 
printers (serial) require half duplex set in IBAUD. [IIOBYa is 
the only location set for parallel printers.] 


Setting IBAUD, IBAUIH-1 and IIOBYT for some Serial Printers 


For -a serial Epson and dtrline printers at 1200 baud, odd parity and 7 bits 


IBAUD: 




1 

1 


1 

10 11 

o 

o 

o 

1 1 * 

\ * \ 


- ( - 

1 

1 r i 

I I I , _ 

1 1 

1 1 


1 = Odd parity 
j 1 = parity and 7 bits 

1 = baud rate <= 1200 

10 - full duplex and serial Epson 


The rightmost bit is 1010. Using the binary to hex chart, this 
is A. The leftmost bit is 0011. Using the chart, this is 3* So 
the value for IBAUD is A3* 


IBAUD+1 : The value for 1200 baud is OD. 







II0BY7: | 1 j 1 j 0~T~5~ 


0 ! 0 ! 0 ! T 


11 = serial printer 


01 = CRT as console 


The rightmost bit is 1100, or C (hex). The leftmost bit is 0001, 
or 1 (hex). The value is Cl. 


Por XQNXGFF serial printers (like some Diablos) at 1200 baud, odd parity and 7 
bits: 


I 

IBAUD: | 0 | 1 

o 

o 

o 

' 1 1 

1 * 1 

i 

i 

I - 1 r r 

l J I 1 

i 1 

1 1 

-1- 

1 

! 

1 

1_ 


1 = Odd parity 
1 = parity and 7 bits 
1 = baud rate <= 1200 
'01 = half duplex and XONXOFF printer 


The value is 63* 


IBAUTM-1 : OD. 


IIOBYT: Cl. 


IV.3. DISKMQN.COM — Gaining Primitive Disk Access 


DISKMON is a multifunction program that gives primitive access to a disk. 
Among its uses is the ability to determine if a disk has bad sectors, tracks 
or blocks. Its options are: 

READ This option can be used to read a file, or to read data by track, 
sector or block number. It is not necessary to type "READ," "R M also 
works. Possible commands are: 

R filename.ext 

RBn (B for block, n for number) 

RTn (T for track, n for number) 

RTnSn (T. for track, s for sector, n for number) 

R reads next sector after one of the above commands. Sectors are 
accessed in numerical order, i.e. Sector 2 follows Sector 1. 

EDIT Allows editing of files, tracks, blocks and sectors. EDIT’s commands: 

EDIT filename.ext 
EDIT Bn 
EDIT Tn 
EDIT TnSn 

When editing anything larger than a sector, <RETURN> accesses the next 
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sector. When all sectors have been accessed, X will show after 
<RETURN> is pressed. To halt a display, type <CTRLXS>; to restart the 
display type another <CTRLXS>. A halted display may be aborted by 
pressing <RETURN>. 

Command keys in the EDIT mode: 


<ESC> turns the insert on and off. Keep the insert off until the 
cursor is positioned in the location you wish to edit. 


When the insert is off, the following keys move the cursor 
position: 


For ATARI & For the For some 
Terminals ATARI Terminals 


Action 


<CTRLXH> 

<CTRLXL> 

<CTRLXK> 

<CTRLXJ> 


left arrow 
right arrow 
up arrow 
down arrow 


SHIFT left arrow 
SHIFT right arrow 
SHIFT up arrow 
SHIFT down arrow 


Moves cursor left 
Moves cursor right 
Moves cursor up 
Moves cursor down 


CAPITAL M - 

BACKSPACE 
LINE FEED 


Toggles the insert 
between ASCII/HEX 
Moves cursor left 
Moves cursor down 


If any changes are made during the EDIT mode, DISKMON will ask if you 
want the changes written to the disk. Enter <Y> for yes, <N> for no. 


ALLOC Allocate shows used blocks on a disk. It will also show where a 
particular file resides on a disk. Entering ALLOC will display a chart 
like this: 

BLOCK # 

0. ...49 D Dll H 1 I H H-++-H-H-H m il H-4-H- II H H-H-H- I I I l- H- H - H- 

30... .99 H H-H ++-H- iiiii M H : :::::::::: :::::::::: :::::::::: 

100 .. .149 :::::::::: :::::::::: :::::::::: :::::::::: :::::::::: 

150...199 :::::::::: :::::::::: :::::::::: :::::::::: :::::::::: 

200...242 :::::::::: :::::::::: :::::::::: :::::::::: :: 

+ indicates used block : indicates unused block 

To find the location of a particular file on a disk, enter: 

ALLOC filename.ext<RETURN>. A block map similar to the one above will 
be displayed with +s representing the location of the file. 


MAP MAP verifies a disk and shows either a track or a block map. To get a 
block map, enter MAP B. :s indicate good blocks 

+s indicate errored blocks. 

To get a track map, enter MAP T. :s indicate good sectors 

+s indicate errored sectors 

The track map is longer than the 24 rows of the display screen. The 
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map can be halted by pressing a <CTRLXS>. Another <CTRLXS> will 
restart the display, a <RETURN> will abort it. 


BACKUPsd This command can be used to make backup files (we recommend using 
PIP for this). S is the source drive, d the destination drive. This 
will backup disks using one drive. [One drive users should set 
ONEDSK in DDSYSGEN #5 and use PIP for copying.] The backup can be 
verified by adding a [V] at the end of the command. 


SELn Allows selection of the drive to be used in DISKMON. N is the drive 
number. If you change disks in a drive, you need to log off of the 
drive, then back on, using SEL. 

DIR Displays the file directory of the logged drive. 

BYE Exits DISKHOIT and returns to CP/M. 


IV. 4. MODEM-COM — running a Modem From the RS-232 Port 


MODEM is a version of SM0DEM37 (a CP/M user's group program) that has been 
specifically rewritten for the ATR8000. It has an extensive multifunction 
menu. Directions and explanations for this program are on the ATR8000 CP/M 
disk in the file MODEM.DOC. To read this file, use the built-in TYPE command 
of CP/M. [TYPE MODEM.DOC<RETURN>. <CTRLXS> will halt and restart the display. 
To print the file on your printer, type a <CTRLXP> before pressing <RETUBN>.J 



IV.5• DISKDEF.COM — Compatibility with CP/M Disks from Other Computers 


DISKDEF is a setup program that enables the ATR8000 to read from, write to and 
run disks from other CP/M computers. DISKDEF has an extensive menu of single- 
sided single and double density disk formats. After making a selection, 
DISKDEF asks for the name of the drive that will contain the nonATR8000 CP/M 
disk. After it is run, that particular drive is "setup" to have the necessary 
CP/M characteristics to run programs from the nonATR8000 disk, to read it and 
to write to it. To write to disks for other computers that do not use one of 
the formats in DDINIT, simply format the disks needed in the other computer 
before using them in the AIR8000. 

Some of DISKDEF*s format selections are: 


For 5 1/4" disks: 


Osborne I (SD) 

Osborne II (DD) 

Generic 256 x 16 


NEC PC-8001 A (DD) 

Generic 256 x 18 

Kaypro II (DD) 

Xerox 820-11 (DD) 

Generic 512 x 9 

TRS-80 MOD I (Omikron, SD) 

Morrow Micro Decision (DD) 

Generic 512 x 10 

Heathkit H89 (Magnolia, DD) 

Zenith Z-100 (DD) 

Generic 1024 x 5 

IBM-PC (CP/M-86) 

DEC Robin (DD) 



For 8" disks: 


Generic 256 x 26 

Generic 512 x 15 

Generic 1024 x 9 

Generic 512 x 16 

Generic 1024 x 8 



* Generic formats describe bytes and sectors. All generic formats are 
options in SWP's Dual Density upgrades for the Xerox 820 and the Bigboard. 


When DISKDEF is run, a menu of disk formats, including the above selections, 
appears. Each format has a number. The screen te lls you to: 

enter number of desired disk type or press 
<CR> to view next screen or *C to exit ... 

? 

Type a selection and <RETUR1T>. The next question asks for the name of the 
drive that is to be set up to read the disk. Put a disk of the selected format 
into the drive of your choice (do not use A unless ONEDSK is set for a single 
drive system). Then enter the name of the drive and press <RETURN>. 

If the disk is not in the selected drive, if it is in the drive improperly, or 
if it is not the same as the "chosen format, an error message will appear: 

BIOS error on _: not ready? 

Correct the error and press <RETURN>. The screen will display the format 
selection and the drive that is set for that format. For example: 



I 


B: set to OSBORNE I format 

Then the CP/M prompt will show. Once a drive is set to another computer’s 
format, the chosen computer’s disks used in that drive can be read from, 
written to or programs can be run. If writing to such disks, the disks will 
have to be preformatted using the other computer’s format program. 


Terminals and Inverse Video 


Some programs, like OSBORNE programs, use inverse video in their displays. The 
ATARI properly displays this. ATRQOOO-Terminal users may have to set their 
terminal to be able to display inverse video (otherwise the inverse portion of 
the display will be very light). The command for an Adds Viewpoint terminal to 
use inverse video is <ESCXOXP>. For other terminals, consult the terminal's 
manual. 
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V. Technical Information 


This section contains technical information concerning CP/M and the ATR8000. 
This information is mainly for reference. 


V.l. Interpreting CP/M Error Messages: the Status Register 


The Status Register monitors various conditions in the floppy disk controller 
(part of the circuitry of the ATR8000's board). This register is made up of 8 
bits, with each individual status bit having its own meaning. 

When a CP/M error message appears on the screen, it may be followed by a 
number. This number refers to one or more of the status bits. [Although some 
of the status bits point out errors, not all do. Some simply tell which 
conditions in the floppy disk controller are active.] The Status Register 
chart below shows the individual bits (Bits 0-7)* The decimal equivalent of 
each bit is also referenced because the SWP BIOS uses decimal output for error 
messages. 

To use the following chart, first determine the type of command that was 
active when the error message occurred (whether the floppy disk controller was 
trying to seek, read, or write). Then cross reference this command with the 
decimal number that appeared in the error message. 

For example, ERROR 64, when the system was trying to write to a disk, means 
that there is a write protect error. This means that you were attempting to 
write to a disk that was write protected (for example, if an 8" disk is 
involved, you need to place a write-protect tab on it, a 5 1/4" disk needs the 
tab removed). 

If a number in an error message is not one of the 8 decimal numbers above (1, 
2, 4, 8, 16, 32, 64, or 128), then it is a combination of two. For example, 
ERROR 24 means that there is a problem with Bit 4 (16 decimal) and with Bit 3 
(8 decimal). More detailed explanation of the bit meanings follow the chart. 


Chart 1: A Summary of the Status Register 



STATUS BITS 


COMMAND 

Bit y 

Bit g 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit £ 

Bit 0 



Decimal 0^ 

Decimal 02 

Decimal 

Decimal g 


■ .. ' 

5 jjl 

Seek 

NOT READY 

WRITE 

PROTECT 

HEAD 

LOADED 

SEEK 

ERROR 

CRC 

ERROR 

TRACK 0 

INDEX 

BUSY 

Read 

NOT READY 

- 

RECORD 

TYPE 

RECORD 

NOT 

FOUNO 

CRC 

ERROR 

LOST 

DATA 

DATA 

REOUEST 

BUSY 

Write 

NOT READY 

WRITE 

PROTECT 

WRITE 

FAULT 

RECORD 

NOT 

FOUND 

CRC 

ERROR 

LOST 

DATA 

DATA 

REQUEST 

BUSY 




































NOT READY indicates that the requested drive is not ready. It can occur if the 
drive door is not closed, or if you inadvertently try to access a drive that 
doesn’t exist. 

WRITE PROTECT means that the write protect feature is active and the disk 
cannot he written to. To write to an 8” disk, you must place a foil write- 
protect tab on the disk. To write to a 5 1/4" disk, you must remove the write- 
protect tab from the disk. 

HEAD LOADED means that the drive head is loaded and engaged. 

RECORD TYPE. When a record is being read, this indicates the record-type code 
from the data field address mark. 1= deleted data mark. 0= normal data mark. 

WRITE FAULT indicates that there is a fault in writing. 

SEEK ERROR means that the desired track was not verified. 

RECORD NOT FOUND means that the desired track, sector, or side was not found. 

CRC ERROR means that there was a checksum error in data in a sector. If this 
occurs with a RECORD NOT FOUND or a SEEK error (decimal 24),. then there is an 
error in one or more ID fields. If it occurs alone, it indicates error in a 
data field. 

TRACK 0 indicates that the drive’s Read/Write head is positioned to Track 0. 

LOST DATA occurs when the computer did not respond to a data request in one 
byte time. This happens when you try to read a longer sector than the active 
program was expecting. 

INDEX means that the index mark is detected from the drive. 

DATA REQUEST is a copy of the data request output. It indicates that the data 
request is full on a read operation, or that the data request is empty on a 
write operation. 

BUSY means that a command is under execution. 



V.2. Keyboard Codes 


The keyboard codes consist of two coordinates, X,Y, that represent a unique 8- 
bit code for each character. X represents the four most significant bits of 
the code; Y represents the four least signicant bits. 


As marked, some of the codes are produced by more than one key. These are: 


Code (HEX) 1st key 2nd key 
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V.3» Display Control Codes and Escape Sequences for the CRT 


While running CP/M, there are several control sequences to enhance system 
operation. These control codes and escape sequences control the video display 
to perform sophisticated screen manipulations. The ATR8000 responds to the 
following codes when CP/M is running and they are sent to the CRTOUT routines 
in the BIOS. 


CONTROL CODES 


Code (hex) 

Sequence 

Function and Description 

07 

CTRL G 

Bell. This code will sound a short tone to alert the 
operator. 

08 

CTRL H 

Backspace/ Cursor Left. Moves the cursor back one 
column position (to the left) without altering the 
character under the cursor. 

09 

CTRL I 

Horizontal Tab. Moves the cursor to the next tab 
stop. Tabs are preset for every eighth column. 

OA 

CTRL J 

Linefeed/ Cursor Down. Moves the cursor down a line. 
If cursor is at bottom of screen, scrolls screen up. 

OB 

CTRL K 

Cursor Up. Moves the cursor up one row without 
effecting the current column position. If cursor is 
at the top of screen, scrolls screen down. 

OC 

CTRL L 

Cursor Rigjht. Moves the cursor one column position to 
the right without altering the character under the 
cursor. 

OD 

CTRL M 

Carriage Return. Returns the cursor to the first 
column position of the current row. 

1A 

CTRL Z or 
CTRL TAB 

Clear Screen and Home Cursor. Clears the entire 
screen and places the cursor in the home position 
(Column 0, Row 0). 

IB 

CTRL [ 

Escape. The first character of an escape sequence. 
(Escape sequences follow.) 

IE 

CTRL < 

Home Cursor. Moves the cursor to the home position 
(Column 0, Row 0) without otherwise effecting the 
screen display. 

IP 

CTRL > 

Display Next Character Direct. After receiving this 
display code, the next character is displayed 
directly on the screen without interpreting it as a 
special display function code. 
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ESCAPE SEQUENCES 


Code (hex) Sequence 
28 ESC ( 


29 ESC ) 


2A 

ESC * 

37 

ESC 7 


3D ESC = 


Function and Description _ 

Disable Attribute Display. Will cause all succeeding 
characters displayed on the screen to unconditionally 
have the upper bit reset, so that the selected 
attribute mode will not be displayed. Display will 
continue in this mode until changed by the "ESC )" 
sequence. 

Enable Attribute Display. Setting this mode will 
cause all following characters displayed on the 
screen to unconditionally have the upper bit set, 
thereby causing the selected attribute mode to be 
displayed. This mode will continue in effect until 
the "ESC (" mode disables it. 

Clear Screen. Clears the screen and moves the cursor 
to the home position. 

Set Inverse Video Attribute Mode. This code will not 
act ually begin displaying inverse video characters on 
the screen. An ESC ) sequence is used to enable the 
display of the attribute characters, or storing 
characters on the screen with the upper bit set, as 
described above. Thus, different attribute modes can 
be selected without affecting the screen display as 
long as there are NO characters on the screen with 
the upper bit set. If there are characters displayed 
on the screen with the upper bit set, changing 
attribute modes will cause an immediate change in the 
way the upper bit characters are displayed, depending 
on the attribute mode. 

IT Cursor Position Leadin. Position the cursor to the 
location indicated by the following two row and 
column codes. The "home" position is designated as 
Row 0, Column 0. An offset of 20h must be added to 
the X and Y position codes. The positioning formula 
is: 


ESC=(X+20h) (Y+20h) 

where legal Y (column) values are between 0 and 79 
and legal X (row) values are between 0 and 23* If a 
column or row position code exceeds the normal 80 
column or 24 row boundaries, that row or column is 
set to 0. 


ESC E Line Insert. Will move the entire line the cursor 
resides on down one line, filling the cursor line 
with blank spaces, and causing the bottom line on the 
screen to disappear. 
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Code (hex) Sequence Function and Description __ 

51 ESC Q Character Insert. Will insert a space at the current 

cursor position, causing the character under the 
cursor and all characters after the cursor to be 
shifted one position to the right. The last character 
on the line will disappear. 

52 ESC R Line Delete. Similar to the line insert function. The 

line on which the cursor resides will be deleted from 
the screen and all lines below it will be moved up 
one line. The position of the cursor will not change. 

57 ESC V Character Delete. This will delete the character 

under the cursor and cause all characters to the 
right of the cursor to move one position to the left. 
The last character position of the line will be 
replaced by a space. 

54 ESC T Clear to End of Line. Clears all characters from the 

current cursor position to the end of the current 
line, inserting spaces. The cursor position is 
unchanged and the characters before the cursor are 
unchanged. 

59 ESC Y Clear to End of Screen. Clears all characters to 

spaces beginning with the current cursor position and 
ending with the end of the screen. Characters before 
the cursor remain unchanged and the cursor position 
remains the same. 

3C ESC < Scroll Left. Scrolls the screen display to the left. 

When the first 40 character positions are displayed 
on the screen no further action takes place. This and 
the Scroll Right function allow the display of any 40 
character section of the 80 character line width. 

3E ESC > Scroll Right. Scrolls the screen display to the 

right. When the last 40 characters of a line are 
displayed on the screen, no further action is taken. 

59 ESC Zn Auto Return/ Auto Scroll Up/ Auto Scroll Down/ Auto 

Display. These four features of the terminal program 
can be turned on and off by an ESC Z sequence. The 
key following the sequence (n) is stored by the 
program and is used to control these features. 
Chart 5 shows the ESC Z codes. 

Auto Return. The default is on. This feature 
automatically performs a carriage return line feed 
when the cursor is in the last display column, Column 
79 (the 80th column), and the terminal program is 
sent another character (the character goes to the 
first column, Column 0, of the next row). 

Auto Scroll Up. The default is on. This automatically 
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scrolls the screen up when the cursor is in the 24th 
row, How 23 - the last shown row), and it is moved 
down. 

Auto Scroll Down. The default is on. ihis 
automatically scrolls the screen down one row when 
the cursor is in the first row, Row 0, and it is 
moved up. 

Auto Position. The default is off. This automatically 
switches the display window to show the first 40 
columns of the display space, Columns 0 - 39, or to 
show the last 40 columns of the display space, 
Columns 40 - 79, depending on the location of the 
cursor. Thus, when the display window shows the first 
40 columns, and the cursor is moved to Column 40, the 
display window shifts to show the last 40 columns so 
that the cursor is kept in view. 


Chart 3: ESC Z Codes 
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V.4- Display Character Codes 


This table shows the code for each character to be displayed by the ATR8000 
system. Each character is defined by a unique eight bit code which is 
represented by a hexadecimal code M XY" where X represents the 4 most 
significant bits of the code and Y represents the 4 least significant bits of 
the code. 

There are a total of 128 characters in the font set. Therefore, Y represents a 
hexidecimal number from 0 to F and X represents a hexidecimal number from 0 to 
7. Thus the complete font set is defined by codes from 00 to 7F. 


Chart 4: ATARI Display Character Codes 


\ Y 
\ls 

X 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 


F 

0 

E 

1 

0 

E 

m 

r] 

m 

m 

a 

1 

(5 

1 

m 

[2 

□ 

M 

1 

s' 

0 

© 

o 

□ 

FI 

ID 

S 


Q) 

© 


Q 

O 

s 

s 




■> 

•jwr 

space 

1 

t« 

a 

$ 

7> 

& 

. 

( 

) 

* 

+ 

t 


• 

/ 

-f 

3 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

• 

• 

• 

» 

< 

= 

> 

? 

4 

0 

A 

3 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

0 

5 

p 

Q 

R 

S 

n 

X 

U 

V 

V 

X 

Y 

z 

[ 

\ 

] 

A 

— 

6 

□ 

a 

b 

c 

d 

e 

f 

S 

h 

i 

3 

k 

1 

m 

n 

0 

7 

"p 

q. 

r 

s 

t 

u 

V 

w 

X 

y 

z 

Q 

i 

d 

□ 

□ 


These codes cannot be generated from the ATARI keyboard. They can only be displayed 
if a program sends the code to the ATR8000. (Notice that these coordinates are not 

in the Keyboard Codes Chart.) 












The display characters in the first two lines of Chart 4, Lines 0 and 1 can 
only be displayed after a CTRL > sequence. This can be done by using an’echo 
program (a program that reads in keyboard entries and sends it back) or can be 
done in a program running on the ATR8000. They cannot be directly accessed 
from the keyboard. 

For example, using an echo program to display the charaacter at the 
coordinates 0,1 (X,Y) in this chart, you first send a CTRL >. Then you refer 
to the Keyboard Code chart (Chart 2) and get the code for 0,1. This code is 
CTRL A. Send CTRL A and the character will be displayed on the screen. 





DIGITAL RESEARCH 

OPERATING SYSTEM END USER LICENSE AGREEMENT 


Use and possession of this software package 
is governed by the following terms. 


1. DEFINITIONS - These definitions shall 
govern: 

A. “DRI” means DIGITAL RESEARCH 
INC., P.O. Box 579, Pacific Grove, 
California 93950, the author and 
owner of the copyright on this 
SOFTWARE. 

B. "CUSTOMER” meansthe individ¬ 
ual purchaser and the company 
CUSTOMER works for, if the com¬ 
pany paid for this SOFTWARE. 

C. "COMPUTER” is the single micro¬ 
computer on which CUSTOMER 
uses this program. Multiple CPU 
systems may require supplemen¬ 
tary licenses. 

D. “SOFTWARE" is the set of com¬ 
puter programs in this package, 
regardless of the form in which 
CUSTOMER may subsequently 
use it, and regardless of any modi¬ 
fication which CUSTOMER may 
make to it. 

E. “LICENSE” means this Agreement 
and the rights and obligations 
which it creates under the United 
States Copyright Law and Califor¬ 
nia laws. 


2. LICENSE 

DRI grants CUSTOMER the right to use this 
serialized copy of the SOFTWARE on a sin¬ 
gle COMPUTER at a single location so long 
as CUSTOMER complies with the terms of 
the LICENSE, and either destroys or returns 
the SOFTWARE when CUSTOMER no 
longer has this right. CUSTOMER may not 
transfer the program electronically from 
one computer to another over a network. 
DRI shall have the right to terminate this 
license if CUSTOMER violates any of its 
provisions. CUSTOMER owns the diskette(s) 
purchased, but under the Copyright Law 
DRI continues to own the SOFTWARE 
recorded on it and all copies of it. CUSTO¬ 
MER agrees to make no more than five (5) 


copies of the SOFTWARE for backup pur¬ 
poses and to place a label on the outside of 
each backup diskette showing the serial 
number, program name, version number 
and the DRI copyright and trademark no¬ 
tices in the same form as the original copy. 
CUSTOMER agrees to pay for licenses for 
additional user copies of the SOFTWARE if 
CUSTOMER intends to or does use it on 
more than one COMPUTER. If the micro¬ 
computer on which CUSTOMER uses the 
SOFTWARE is a multi-user microcomputer 
system, then the license covers all users on 
that single system, without further license 
payments, only if the SOFTWARE was reg¬ 
istered for that microcomputer. This is NOT 
a license to use the SOFTWARE on main¬ 
frames or emulators. 


3. TRANSFER OR REPRODUCTION 
CUSTOMER understands that unauthorized 
reproduction of copies of the SOFTWARE 
and/or unauthorized transfer of any copy 
may be a serious crime, as well as subject¬ 
ing a CUSTOMER to damages and attorney 
fees. CUSTOMER may not transfer any 
copy of the SOFTWARE to another person 
unless CUSTOMER transfers all copies, 
including the original, and advises DRI of 
the name and address of that person, who 
must sign a copy of the registration card, 
pay the then current transfer fee, and agree 
to the terms of this LICENSE in order to use 
the SOFTWARE. DRI will provide additional 
copies of the card and LICENSE upon 
request. DRI has the right to terminate the 
LICENSE, to trace serial numbers, and to 
take legal action if these conditions are 
violated. 

4. ADAPTATIONS AND MODIFICA¬ 
TIONS 

CUSTOMER owns any adaptations or mod¬ 
ifications which CUSTOMER may make to 
this SOFTWARE, but in the event the 
LICENSE is terminated CUSTOMER may 
not use any part of the SOFTWARE pro- 


vided by DR! even if CUSTOMER has modi¬ 
fied it. CUSTOMER agrees to take reaso¬ 
nable steps to protect our SOFTWARE from 
theft or use contrary to this LICENSE. 


5. LIMITED WARRANTY 
The only warranty DRI makes is that the 
diskette(s) on which the SOFTWARE is 
recorded will be replaced without charge, if 
DRI in good faith determines that the media 
was defective and not subject to misuse, 
and if returned to DRI or the dealer from 
whom it was purchased, with a copy of the 
original registration card, within ten days of 
purchase. Customer will receive support 
from the Vendor from whom customer has 
purchased the software. In addition, support 
is available from DRI directly, for qualified, 
registered customers under DRI’s then cur¬ 
rent support policies. DRI reserves the right 
to change the specifications and operating 
characteristics of the SOFTWARE it pro¬ 
duces, over a period of time, without notice. 


unless a written amendment has been 
signed by one of our company officers. 
When CUSTOMER opens the SOFTWARE 
package or uses the SOFTWARE, this act 
shall be considered as mutual agreement 
tothe terms of this LICENSE. This LICENSE 
shall be governed by California law, except 
as to copyright matters which are covered 
by Federal laws, and is deemed entered 
into at Pacific Grove, Monterey County, CA 
by both parties. 


6. DRI MAKES NO OTHER WARRANTIES, 
EITHER EXPRESSED OR IMPLIED, AND 
DRI SHALL NOT BE LIABLE FOR WAR¬ 
RANTIES OF FITNESS OF PURPOSE OR 
MERCHANTABILITY, NOR FOR INDIRECT, 
SPECIAL OR CONSEQUENTIAL DAMAGES 
SUCH AS LOSS OF PROFITS OR INABIL¬ 
ITY TO USE THE SOFTWARE. SOME 
STATES MAY NOT ALLOW THIS DIS¬ 
CLAIMER SO THIS LANGUAGE MAY NOT 
APPLY TO CUSTOMER. IN SUCH CASE, 
OUR LIABILITY SHALL BE LIMITED TO 
REFUND OF THE DRI LIST PRICE. CUS¬ 
TOMER MAY HAVE OTHER RIGHTS 
WHICH VARY FROM STATE TO STATE. 
CUSTOMER and DRI agree that this pro¬ 
duct is not intended as "Consumer Goods” 
under state or federal warranty laws. 
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7. MISCELLANEOUS 

This is the only agreement between CUS¬ 
TOMER and DRI and it cannot and shall not 
be modified by purchase orders, advertis¬ 
ing or other representations of anyone, 


by 



SAVE THIS LICENSE FOR FUTURE REFERENCE 
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